From 94305f248b04285ed3386f74f220c7a8b109424a Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Thu, 29 Oct 2020 14:00:13 -0400
Subject: [PATCH] docs: Tweak GdkPopup docs

---
 gdk/gdkpopup.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/gdk/gdkpopup.c b/gdk/gdkpopup.c
index 91772d3c18..375a0fcb92 100644
--- a/gdk/gdkpopup.c
+++ b/gdk/gdkpopup.c
@@ -27,9 +27,13 @@
  * SECTION:gdkpopup
  * @Short_description: Interface for popup surfaces
  * @Title: Popups
+ * @See_also: #GdkToplevel, #GdkSurface
  *
  * A #GdkPopup is a surface that is attached to another surface,
- * and is positioned relative to it.
+ * called its #GdkPopup:parent, and is positioned relative to it.
+ *
+ * #GdkPopups are typically used to implement menus and similar popups.
+ * They can be modal, which is indicated by the #GdkPopup:autohide property.
  */
 
 G_DEFINE_INTERFACE (GdkPopup, gdk_popup, GDK_TYPE_SURFACE)
-- 
2.30.2